filemanager.htmlHTMLudog#,πùΔ£πùΔ£ÅÅ ø Monkeybread Realbasic plugin - Documentation - File Manager

MBS Plugin Documentation

This is the documentation for the Realbasic Plugins from Monkeybreadsoftware.de. You find these plugins and the newest version of this document at http://www.monkeybreadsoftware.de/realbasic inside the plugins section.

This help was last updated on Freitag, 6. September 2002 and covers 2136 items: 126 classes, 2 controls and 583 global functions.

The list of the themes Global methods by category Global methods by name The list of the classes The list of the controls

NewFolderItem(vRefNum as Integer, parID as Integer, name as String) as FolderItem

global method, File Manager So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: returns allways nil.
Function: Creates a FolderItem from a specified volume, the item's directory ID and its name.
Example:
dim f as folderItem

f=newfolderItem(-1)
msgBox f.absolutePath#
Notes: The vRefNum with value -1 is the boot volume on Mac OS.

NewFolderItemFSRef(fsref as memoryblock) as FolderItem

global method, File Manager Di, 23. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: -> nil.
Function: Creates a FolderItem from a specified FSRef.
Example:
dim f,g as folderItem
dim m as memoryBlock

f=getfolderItem("")

m=f.FSRef

g=NewFolderItemFSRef(m)
msgBox g.absolutePath // same path as f
Notes: Only usefull for toolbox calls and on Mac OS 9 and later.

NewFolderItemFSSpec(fsspec as memoryblock) as FolderItem

global method, File Manager So, 21. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: -> nil.
Function: Creates a FolderItem from a specified FSSpec.
Example:
dim f,g as folderItem
dim m as memoryBlock

f=getfolderItem("")

m=f.FSSpec

g=NewFolderItemFSSpec(m)
msgBox g.absolutePath // same path as f
Notes: Only usefull for toolbox calls.

NewVolumeFolderItem(vRefNum as Integer) as FolderItem

global method, File Manager So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: returns allways nil.
Function: Creates a FolderItem from a specified volume based on the volume reference number.
Example:
dim f as folderItem

f=NewVolumeFolderItem(-1)
msgBox f.absolutePath
Notes:
The vRefNum with value -1 is the boot volume on Mac OS.

Pass in the vRefNum of any mounted volume and it returns the Volume as a FolderItem.
Returns nil if the vRefNum was invalid.

VolResolveID(vol as FolderItem, id as Integer) as FolderItem

global method, File Manager So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: returns allways nil.
Function:
return a FolderItem for a passed FileID or DirID. If the item can not be resolved, nil is returned instead.
The first parameter specified the volume where you want to resolve the ID on.
Example:
dim f,g as folderItem
f=desktopfolder
g=VolResolveID(f,f.MacDirID)
msgBox f.absolutePath
Notes: This function returns a FolderItem for a passed FileID or DirID. If the item can not be resolved, nil is returned instead.

VolResolveID(vRefNum as Integer, id as Integer) as FolderItem

global method, File Manager So, 28. Apr 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: returns allways nil.
Function:
return a FolderItem for a passed FileID or DirID. If the item can not be resolved, nil is returned instead.
The first parameter specified the volume where you want to resolve the ID on.
Example:
dim f,g as folderItem
f=desktopfolder
g=VolResolveID(f.macVRefNum,f.MacDirID)
msgBox f.absolutePath
Notes:
This function returns a FolderItem for a passed FileID or DirID. If the item can not be resolved, nil is returned instead.
The first parameter specified the volume where you want to resolve the ID on.There is a bug in RB which may say "type mistmatch error" in RB. Than use the other variant of that function.

Contact

Written 2002 by Christian Schmitz. Feel free to ask or report mistakes to realbasic@macsw.de.
Thanks.

This resource fork intentionally left blank ˇˇ